home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / language / modula2.zoo / read.me < prev   
Text File  |  1989-06-16  |  30KB  |  635 lines
  1. -------------------------------
  2. Dokumentation zum Modula-System                         Stand 12.04.89
  3. -------------------------------
  4.  
  5. Vorwort:
  6. ========
  7. Dieses Modula-2-System wurde für Ausbildungszwecke konzipiert und wird
  8. zur Programmierausbildung für Studenten der Fakultät Elektrotechnik und
  9. Informationstechnik eingesetzt.
  10.  
  11. Mit dieser Public-Domain-Version soll nun allen an Modula-2 Interessierten
  12. die Möglichkeit geboten werden, sich mit dieser Sprache zu beschäftigen.
  13.  
  14. Allerdings muß an dieser Stelle erwähnt werden, daß von Seiten des
  15. Lehrstuhls keine Dokumentation oder ausführliche Anleitung zur Verfügung
  16. steht und daß keinerlei Beratung (weder telefonisch noch schriftlich)
  17. durchgeführt werden kann.
  18.  
  19.  
  20. Die folgenden Hinweise können natürlich kein komplettes Handbuch ersetzen,
  21. sollten aber für die normale Bedienung des Systems ausreichen.
  22.  
  23.  
  24. 1.0 Zusammenstellung der Diskette :
  25. -----------------------------------
  26.  
  27.    - AUTO         (Ordner, mit RAM-Disk)
  28.    - DEF          (Ordner, mit den DEFINITION-Modulen zur Bibliothek)
  29.    - GEMLIB       (Ordner, mit SBM- & OBM-Files für GEM)
  30.    - STDLIB       (Ordner, mit SBM- & OBM-Files der Standardmodule)
  31.    - SYSTEM       (Ordner, mit SBM- & OBM-Files der Systemumgebung)
  32.    - STANDALO.NE  (Ordner, mit OBM-Files, die der Linker benötigt)
  33.    - SBM          (Ordner, mit SBM-Files, die in die RAM-Disk kopiert
  34.                    werden)
  35.    - OBM          (Ordner, mit OBM-Files,            -"-              )
  36.    - WORK         (Ordner, mit den Files, die bearbeitet werden sollen)
  37.    - COPY.LST     (Liste der Files die in die Ramdisk überspielt werden)
  38.    - RAMDISK.INF  (Infodatei der RAM-Disk, Größe, Laufwerksbuchstabe ...)
  39.    - (EDITOR.PRG) (eigener Editor z.B. Tempus)
  40.    - M2PATH.TXT   (Suchpfade der MODULA-SHELL)
  41.    - ERROR.IND    (Fehlermeldungen für den Compiler)
  42.    - MK_COPY.PRG  (Kopierprogramm. Es wird von der RAM-Disk aufgerufen)
  43.    - M2LOADER.PRG (hiermit wird die Shell gestartet)
  44.    - DEBUG.RSC
  45.    - M2SHELL.RSC
  46.    - DESKTOP.INF
  47.    - READ.ME
  48.    - COPYRIGH.T
  49.  
  50.  
  51. 2.0 Modula-Shell :
  52. ------------------
  53.  
  54. 2.1 Hochfahren des Systems
  55.  
  56.     - ATARI einschalten
  57.     - Modula-Diskette einlegen
  58.       ... Der ATARI bootet und installiert die RAM - Disk
  59.       ... Einige Files entsprechend der Datei COPY.LST werden in die
  60.           RAM - Disk geladen
  61.       Jetzt wird der M2LOADER durch Sie auf der RAM-DISK gestartet.
  62.       (Der M2LOADER liest M2Paths.txt; man kann daher auch M2Loader als
  63.        Anwendung anmelden und dann M2LOADER durch Doppelklick auf M2Paths
  64.        starten. Dazu braucht M2LOADER.PRG nicht auf der RAM-Disk sein)
  65.       Im LOADER starten Sie M2SHELL.OBM durch betätigen der RETURN-Taste.
  66.       ...Die Modula-Shell wird nun geladen.
  67.       Jetzt müssen Sie nur noch das DATUM eingeben, falls dies noch nicht
  68.       geschehen ist und schon kann's losgehen.
  69.  
  70.  
  71. 2.1 Bedienung der Shell
  72.  
  73.     - Das Menü 'Desk':
  74.       - M2-Shell: ein paar Informationen zum Modula-2 System.
  75.     - Das Menü 'Modul':
  76.       - Editieren, Übersetzen & Starten bezieht sich jeweils auf die
  77.       Arbeitsdatei (wird in der Desktop-Box angezeigt). Ist noch keine
  78.       Arbeitsdatei ausgewählt, so geschieht dies nach dem Anwählen über
  79.       die Fileselectorbox. Entsprechend wird nun der Editor, der Com-
  80.       piler oder die Datei selbst geladen und ausgeführt.
  81.       Diese Funktionen können auch über die Tastenkombinationen
  82.       <control> E, Ü & S erreicht werden.
  83.       - Editiere ..., Übersetze ... & Starte ... beziehen sich jeweils
  84.       auf eine Datei, die erst noch mit der Fileselectorbox ausgewählt
  85.       wird. Diese Funktionen können auch über die Tastenkombinationen
  86.       <alternate> E, Ü & S erreicht werden.
  87.       - PRG erzeugen bezieht sich auf die aktuelle Arbeitsdatei und ruft
  88.       den Linker auf, der die importierten Module zusammenbindet und ein
  89.       lauffähiges Programm erzeugt. Erraten, das geht auch mit <control> L.
  90.       - Ende oder <control> X und die Shell wird verlassen, in der File-
  91.       selectorbox des M2LOADER muß dann <Abbruch> gewählt werden.
  92.     - Das Menü 'Optionen':
  93.       - Mit Modul auswählen oder <control> A kann die Arbeitsdatei festge-
  94.       legt werden.
  95.       - Mit Suchpfade ändern oder <control> P können die Pfade auf welchen
  96.       die Shell oder der Compiler die benötigten SBM- bzw. OBM-Files sucht
  97.       geändert werden.
  98.       - Mit Terminal öffnen bzw. <control> T können z.B. die letzten
  99.       Ausgaben eines Programms noch einmal untersucht werden, dazu wird das
  100.       Terminal-Window geöffnet.
  101.       - Compiler, Debug: ein paar Parameter können hier geändert werden,
  102.       die voreingestellten Werte sind Erfahrungswerte und müssen in den
  103.       wenigsten Fällen geändert werden.
  104.       - Editor: Hier kann der verwendete Editor gewählt werden, wobei gilt:
  105.                 linker  Eintrag: Editor als PRG-File
  106.                 rechter Eintrag: Editor als OBM-File
  107.                 Der gewählte Editor wird unter dem angezeigten Namen
  108.                 gesucht. Beim 'PRG-Editor' wird er auf dem Pfad erwartet,
  109.                 von dem aus der M2LOADER gestartet wurde.
  110.                 Editor resident bezieht sich auf den 'OBM-Editor'.
  111.       - Backup: Der gerade bearbeitete Text (beim Aufruf des Editors) wird
  112.         auf dem angegebenen Pfad noch einmal abgespeichert, wenn ein Backup
  113.         gewünscht wird. Das ist besonders zu empfehlen, wenn sich die
  114.         Arbeitsdatei in der RAM-Disk befindet.
  115.       - mit *.DEF, *.MOD bearbeiten (<control> D, M) kann man einstellen ob
  116.       ein DEFINITION oder (IMPLEMANTATION) MODUL bearbeitet werden soll.
  117.       Das bezieht sich im besonderen auf den Compiler (existiert TEST.DEF
  118.       und TEST.MOD und soll TEST.DEF übersetzt werden, dann *.DEF bearbeiten
  119.       wählen und den Compiler aufrufen), außerdem werden dann in der File-
  120.       selectorbox nur *.DEF bzw. *.MOD angezeigt.
  121.     - Das Menü 'Datei':
  122.       - Kopieren, Löschen & Umbenennen: Es wird jeweils über die File-
  123.       selectorbox das entsprechende File ausgewählt und danach entweder
  124.       das Zieldirectory oder der neue Name bestimmt.
  125.       - Ausführen: Es kann ein Programm (*.PRG) gestartet werden.
  126.  
  127.  
  128.  
  129. 3.0 Informationen über Linker, Debugger und Compiler :
  130. ------------------------------------------------------
  131.  
  132. 3.1 Allgemeines:
  133.  
  134. - Die Arbeitsumgebung ist in Schichten aufgebaut. Unterste Schicht ist
  135.   der M2LOADER. Auf M2LOADER liegt dann (normalerweise) M2SHELL. Dies
  136.   ist ein Objektmodul d.h. es kann nicht ohne den M2LOADER laufen.
  137.   M2SHELL ruft dann ihrerseits Editor und Compiler auf.
  138.   Wird ein compiliertes Programm gestartet, so läuft es, wenn es
  139.   noch nicht gelinkt ist, wie alle ".OBM"- Programme unter Kontrolle
  140.   von M2LOADER, der bei Laufzeitfehlern den Debugger starten kann.
  141.   M2SHELL, der Compiler, der Editor und der Debugger bleiben, wenn sie
  142.   einmal geladen sind, resident.
  143.  
  144. - M2PATHS.TXT.
  145.   Diese Datei kann wie jede Textdatei mit dem Editor bearbeitet werden.
  146.   In ihr stehen Suchpfade, die der Compiler, der Debugger, die Shell
  147.   und M2LOADER auf der Suche nach Dateien benutzen.
  148.   Außerdem kann der Defaultaufruf des M2LOADER eingetragen werden. D.h.
  149.   diejenige Objekt-Datei, deren Name in der letzten Zeile nach @M steht,
  150.   wird vom M2LOADER vorgewählt und kann durch Anklicken von [OK] gestartet
  151.   werden.
  152.   In der vorletzten Zeile dieser Datei steht der Suchpfad (der letzte
  153.   Suchpfad) der als Default für Funktionen wie Modul auswählen usw.
  154.   verwendet wird.
  155.   Der vorletzte Suchpfad wird als Voreinstellung für den Backup-Pfad
  156.   verwendet und sollte sinnigerweise keine RAM-Disk als Ziel haben.
  157.   Fehlt die Angabe des Laufwerkes in einem Pfad, so bezieht sich dieser
  158.   auf den aktuellen Pfad des GEMDOS, im allgemeinen der Pfad von dem aus
  159.   der M2LOADER gestartet wurde.
  160.   Jeder Pfad muß mit '\' enden, denn intern wird nur noch der Filename an
  161.   den Pfad angehängt.
  162.   Maximal 15 Pfadnamen können angegeben werden.
  163.  
  164.  
  165. 3.2 Der Linker (Standalone Programme):
  166.  
  167. - Da man, wenn man "ernsthaft" programmieren will Programme ohne
  168.   den Schutz von M2LOADER laufen lass